Skip to content

Add release notes for 1.38.0#6702

Open
ikhoon wants to merge 4 commits intoline:mainfrom
ikhoon:claude/wizardly-williamson
Open

Add release notes for 1.38.0#6702
ikhoon wants to merge 4 commits intoline:mainfrom
ikhoon:claude/wizardly-williamson

Conversation

@ikhoon
Copy link
Copy Markdown
Contributor

@ikhoon ikhoon commented Apr 3, 2026

  • Add release notes for Armeria 1.38.0
  • Add .claude/skills/release-note/ skill that automates generating and polishing release notes from a GitHub milestone
# In Claude Code
> /release-note <version>

- Add .claude/skills/release-note/ skill that automates generating and
  polishing release notes from a GitHub milestone
- Add references/style-guide.md with annotated formatting examples
- Add release notes for Armeria 1.38.0

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 3, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 188677c2-b4b8-43e8-9e0b-4992d402e0a6

📥 Commits

Reviewing files that changed from the base of the PR and between 4af07ca and 7ca5c3b.

📒 Files selected for processing (1)
  • site-new/src/content/release-notes/1.38.0.mdx
🚧 Files skipped from review as they are similar to previous changes (1)
  • site-new/src/content/release-notes/1.38.0.mdx

📝 Walkthrough

Walkthrough

Adds a new Claude skill for end-to-end release-note generation and polishing, an Armeria release-notes style guide, and the finalized v1.38.0 release notes MDX page.

Changes

Cohort / File(s) Summary
Release Notes Skill
​.claude/skills/release-note/SKILL.md
New Claude skill implementing /release-note <version> workflow: milestone validation, run site-new generator, verify draft MDX, sample prior notes, extract PR/issue refs, fetch PR/issue metadata & comments, special handling for new-feature PRs, triage 🗑 Maybe ignore, apply style-guide rewriting/formatting rules, normalize dependencies, dedupe contributors, write final MDX, and report per-section counts and uncertainties.
Style Guide
​.claude/skills/release-note/references/style-guide.md
New authoritative release-notes style guide: templates and formatting rules for major/minor features, improvements, bug fixes, breaking changes, docs, dependencies, contributor/ThankYou formatting, explicit exclusions, and strict type-link rules.
Release Notes Content
site-new/src/content/release-notes/1.38.0.mdx
Adds finalized v1.38.0 release notes (2026-04-07) documenting new features (HTTP/JSON→gRPC proxy, KubernetesEndpointGroup POD mode, Envoy HTTP/1.1 bridge, built-in properties, token preloading, Athenz token client/metrics, xDS SDS enhancements), improvements, a bug fix, dependency bumps, and a populated ThankYou contributor list.

Sequence Diagram(s)

sequenceDiagram
    participant User as User
    participant Claude as Claude Skill
    participant GH as GitHub API
    participant Gen as site-new Generator
    participant FS as File System

    rect rgba(200,220,255,0.5)
    User->>Claude: trigger /release-note <version>
    end

    rect rgba(200,255,220,0.5)
    Claude->>GH: validate milestone exists
    GH-->>Claude: milestone status
    Claude->>Gen: run release-note generator
    Gen-->>Claude: draft MDX path
    Claude->>FS: verify draft file exists & load draft
    FS-->>Claude: draft content
    end

    rect rgba(255,230,200,0.5)
    Claude->>GH: fetch referenced PRs/issues, metadata, files, comments
    GH-->>Claude: PR/issue data + comments + files
    Claude->>Claude: triage "🗑 Maybe ignore", sample prior notes, apply style-guide rules, rewrite entries
    Claude->>FS: write finalized MDX
    FS-->>Claude: write confirmation
    end

    Claude-->>User: summary + per-section counts + uncertain items
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Suggested reviewers

  • trustin
  • jrhee17
  • minwoox

Poem

🐰 I hopped through drafts and PR trails bright,
Sniffed labels, fetched comments late at night.
Tidy bullets, sample notes in tune —
V1.38.0 polished, under the moon 🥕

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title 'Add release notes for 1.38.0' directly and clearly summarizes the main change in the PR—introducing release notes documentation for Armeria version 1.38.0.
Description check ✅ Passed The description is directly related to the changeset, covering the primary objective of adding release notes for 1.38.0 and the supporting skill automation for generating release notes.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@ikhoon ikhoon added this to the 1.38.0 milestone Apr 3, 2026
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (6)
.claude/skills/release-note/SKILL.md (6)

37-39: Add language identifier to code block.

The shell command block should specify shell or bash for proper syntax highlighting.

📝 Proposed fix
-   ```
+   ```shell
    cd site-new && npm run release-note <version>
    ```
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.claude/skills/release-note/SKILL.md around lines 37 - 39, The fenced code
block containing the shell command `cd site-new && npm run release-note
<version>` needs a language identifier for proper syntax highlighting; update
the block start from ``` to ```shell (or ```bash) so the snippet is ```shell cd
site-new && npm run release-note <version> ``` which ensures correct
highlighting in SKILL.md.

55-57: Add language identifier to code block.

The shell command block should specify shell or bash for proper syntax highlighting.

📝 Proposed fix
-   ```
+   ```shell
    gh pr view <number> --repo line/armeria --json title,body,labels,files
    ```
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.claude/skills/release-note/SKILL.md around lines 55 - 57, The code block
showing the GitHub CLI command `gh pr view <number> --repo line/armeria --json
title,body,labels,files` needs a language identifier for proper syntax
highlighting; update the fenced code block around that command to include a
shell identifier such as "shell" or "bash" (e.g., change the opening ``` to
```shell) so the `gh pr view` command is highlighted correctly in the rendered
document.

67-70: Add language identifier to code blocks.

Both shell command blocks should specify shell or bash for proper syntax highlighting.

📝 Proposed fix
-   ```
+   ```shell
    gh issue view <number> --repo line/armeria --json title,body
    gh api repos/line/armeria/issues/<number>/comments --jq '.[].body'
    ```
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.claude/skills/release-note/SKILL.md around lines 67 - 70, Update the
Markdown code fences around the two shell command blocks so they include a
language identifier (e.g., "shell" or "bash") for proper syntax highlighting;
locate the fenced block that contains the commands "gh issue view <number>
--repo line/armeria --json title,body" and "gh api
repos/line/armeria/issues/<number>/comments --jq '.[].body'" and change the
opening triple backticks to ```shell (or ```bash) to annotate the block.

61-63: Add language identifier to code block.

The shell command block should specify shell or bash for proper syntax highlighting.

📝 Proposed fix
-   ```
+   ```shell
    gh api repos/line/armeria/pulls/<number>/comments --jq '.[].body'
    ```
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.claude/skills/release-note/SKILL.md around lines 61 - 63, The fenced code
block containing the command "gh api repos/line/armeria/pulls/<number>/comments
--jq '.[].body'" needs a language identifier for proper highlighting; update the
triple-backtick fence to include "shell" or "bash" (e.g., ```shell) before that
command so the snippet in SKILL.md renders with shell/bash syntax highlighting.

22-24: Add language identifier to code block.

The code block should specify shell or bash for proper syntax highlighting.

📝 Proposed fix
-```
+```shell
 /release-note <version>
</details>

<details>
<summary>🤖 Prompt for AI Agents</summary>

Verify each finding against the current code and only fix it if needed.

In @.claude/skills/release-note/SKILL.md around lines 22 - 24, Update the fenced
code block that currently contains "/release-note " in SKILL.md to
include a language identifier (e.g., shell or bash) for proper syntax
highlighting; locate the triple-backtick block around the "/release-note
" snippet and change the opening fence from toshell (or


33-35: Add language identifier to code block.

The shell command block should specify shell or bash for proper syntax highlighting.

📝 Proposed fix
-   ```
+   ```shell
    gh api repos/line/armeria/milestones --jq '.[] | select(.title == "<version>") | .number'
    ```
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.claude/skills/release-note/SKILL.md around lines 33 - 35, Update the fenced
code block containing the GitHub CLI command "gh api
repos/line/armeria/milestones --jq '.[] | select(.title == \"<version>\") |
.number'" to include a language identifier (e.g., ```shell or ```bash)
immediately after the opening backticks so the snippet renders with proper shell
syntax highlighting in the SKILL.md document.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In @.claude/skills/release-note/SKILL.md:
- Around line 37-39: The fenced code block containing the shell command `cd
site-new && npm run release-note <version>` needs a language identifier for
proper syntax highlighting; update the block start from ``` to ```shell (or
```bash) so the snippet is ```shell cd site-new && npm run release-note
<version> ``` which ensures correct highlighting in SKILL.md.
- Around line 55-57: The code block showing the GitHub CLI command `gh pr view
<number> --repo line/armeria --json title,body,labels,files` needs a language
identifier for proper syntax highlighting; update the fenced code block around
that command to include a shell identifier such as "shell" or "bash" (e.g.,
change the opening ``` to ```shell) so the `gh pr view` command is highlighted
correctly in the rendered document.
- Around line 67-70: Update the Markdown code fences around the two shell
command blocks so they include a language identifier (e.g., "shell" or "bash")
for proper syntax highlighting; locate the fenced block that contains the
commands "gh issue view <number> --repo line/armeria --json title,body" and "gh
api repos/line/armeria/issues/<number>/comments --jq '.[].body'" and change the
opening triple backticks to ```shell (or ```bash) to annotate the block.
- Around line 61-63: The fenced code block containing the command "gh api
repos/line/armeria/pulls/<number>/comments --jq '.[].body'" needs a language
identifier for proper highlighting; update the triple-backtick fence to include
"shell" or "bash" (e.g., ```shell) before that command so the snippet in
SKILL.md renders with shell/bash syntax highlighting.
- Around line 22-24: Update the fenced code block that currently contains
"/release-note <version>" in SKILL.md to include a language identifier (e.g.,
shell or bash) for proper syntax highlighting; locate the triple-backtick block
around the "/release-note <version>" snippet and change the opening fence from
``` to ```shell (or ```bash).
- Around line 33-35: Update the fenced code block containing the GitHub CLI
command "gh api repos/line/armeria/milestones --jq '.[] | select(.title ==
\"<version>\") | .number'" to include a language identifier (e.g., ```shell or
```bash) immediately after the opening backticks so the snippet renders with
proper shell syntax highlighting in the SKILL.md document.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 89b0212c-d376-41ee-9b20-cfb0b9feb4b2

📥 Commits

Reviewing files that changed from the base of the PR and between 11eefbf and 4c3945a.

📒 Files selected for processing (3)
  • .claude/skills/release-note/SKILL.md
  • .claude/skills/release-note/references/style-guide.md
  • site-new/src/content/release-notes/1.38.0.mdx

- Always include core maintainers from CODEOWNERS in Thank You section
- Clarify issue/PR reference format in style guide

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.claude/skills/release-note/references/style-guide.md:
- Around line 34-35: The guideline "`#6607` issue/PR references at end of
description line (list both the issue and the PR)" conflicts with the examples
that show single-reference entries; update the document so the rule and examples
are consistent by either (A) revising the rule to allow a single reference when
only one identifier exists (e.g., keep examples as-is and add a sentence like
"If only an issue OR a PR exists, a single reference is acceptable"), or (B)
changing the examples to always show paired issue+PR references; ensure you
update the rule text (the quoted rule) and all example instances that currently
show single references (those around the examples that follow the rule) so they
match the clarified policy.
- Around line 11-27: The MDX block currently opens with ```mdx and then contains
an inner ```java fence which prematurely closes the outer block; update the
outer fence to a longer delimiter so the inner ```java can be nested (e.g.
change the outer ```mdx start and its matching closing fence to ````mdx / ````),
ensuring the inner ```java ... ``` remains intact and the MD040 lint error is
resolved; look for the ```mdx and ```java fences around the "Standalone Athenz
Token Validation" example to apply this change.

In @.claude/skills/release-note/SKILL.md:
- Around line 22-24: Add the missing language identifiers ("bash") to the fenced
code blocks in .claude/skills/release-note/SKILL.md so markdownlint MD040 is
satisfied; locate the code fences containing the command snippets (e.g. the
block with "/release-note <version>", and the blocks containing "gh api
repos/line/armeria/milestones --jq '.[] | select(.title == \"<version>\") |
.number'", "cd site-new && npm run release-note <version>", "gh pr view <number>
--repo line/armeria --json title,body,labels,files", "gh api
repos/line/armeria/pulls/<number>/comments --jq '.[].body'", and the
issue/comment query blocks) and change each opening triple backtick to ```bash
so every command fence is annotated with the bash language.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 7220df8a-3acf-402a-81ee-a4b0951a77a8

📥 Commits

Reviewing files that changed from the base of the PR and between 4c3945a and 7f4f387.

📒 Files selected for processing (3)
  • .claude/skills/release-note/SKILL.md
  • .claude/skills/release-note/references/style-guide.md
  • site-new/src/content/release-notes/1.38.0.mdx
✅ Files skipped from review due to trivial changes (1)
  • site-new/src/content/release-notes/1.38.0.mdx

@codecov
Copy link
Copy Markdown

codecov bot commented Apr 3, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.97%. Comparing base (8150425) to head (7ca5c3b).
⚠️ Report is 398 commits behind head on main.

Additional details and impacted files
@@             Coverage Diff              @@
##               main    #6702      +/-   ##
============================================
- Coverage     74.46%   73.97%   -0.49%     
- Complexity    22234    24047    +1813     
============================================
  Files          1963     2171     +208     
  Lines         82437    90232    +7795     
  Branches      10764    11834    +1070     
============================================
+ Hits          61385    66753    +5368     
- Misses        15918    17880    +1962     
- Partials       5134     5599     +465     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@ikhoon
Copy link
Copy Markdown
Contributor Author

ikhoon commented Apr 6, 2026

image

@ikhoon ikhoon marked this pull request as ready for review April 6, 2026 07:36
Copy link
Copy Markdown
Contributor

@minwoox minwoox left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 👍 👍

Comment on lines +26 to +30
KubernetesEndpointGroup.builder(kubernetesClient)
.namespace("my-namespace")
.serviceName("my-service")
.mode(KubernetesEndpointMode.POD) // 👈👈👈
.build();
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
KubernetesEndpointGroup.builder(kubernetesClient)
.namespace("my-namespace")
.serviceName("my-service")
.mode(KubernetesEndpointMode.POD) // 👈👈👈
.build();
KubernetesEndpointGroup.builder(kubernetesClient)
.namespace("my-namespace")
.serviceName("my-service")
.mode(KubernetesEndpointMode.POD) // 👈👈👈
.build();

Comment on lines +60 to +64
AthenzTokenClient.builder(ztsBaseClient)
.domainName("my-domain")
.roleNames("my-role")
.build();
tokenClient.getToken().thenAccept(token -> { // 👈👈👈
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
AthenzTokenClient.builder(ztsBaseClient)
.domainName("my-domain")
.roleNames("my-role")
.build();
tokenClient.getToken().thenAccept(token -> { // 👈👈👈
AthenzTokenClient.builder(ztsBaseClient)
.domainName("my-domain")
.roleNames("my-role")
.build();
tokenClient.getToken().thenAccept(token -> { // 👈👈👈

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants